process.htmlHTMLudogDíπùΔ§πùΔ§ÅÅå Monkeybread Realbasic plugin - Documentation - Process

MBS Plugin Documentation

This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.

This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.

The list of the themes Global methods by category Global methods by name The list of the classes The list of the controls

class Process
class, Process Do, 1. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: Adds the class Process to Realbasic to get details about all running applications.
Notes: Requires Windows 95 or Windows 2000 to run on Windows.

CPUTime as integer
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return 0.
Function: Returns the number of the ticks this process did get to calculate.
Notes:
Unit is 1/60 of a second.
On Mac OS X this value is not available and normally 0.

CurrentProcess as boolean
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return false.
Function: Returns true if the application is in the current process.
Notes: This should allways be true because you are running Realbasic as the current process while you ask for this.

FrontProcess as boolean
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return false.
Function: Returns true if the application is in the front of all others.
Example: app.frontprocess=True 'bring app to front
Notes: This property is for read and write. Writing to it brings the process to front.

GetCurrentProcess
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Load the current process' information into the class.
Notes: This should allways be your Realbasic application.

GetfirstProcess
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Load the first process into the class.
Example:
dim p as process
p=new process
p.GetfirstProcess ' get first
do
msgBox p.name
loop until not p.GetNextProcess ' get next till no more

GetFrontProcess
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Load the frontmost process' information into the class.

GetNextProcess
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Load the next process into the class.
Example:
dim p as process
p=new process
p.GetfirstProcess ' get first
do
msgBox p.name
loop until not p.GetNextProcess ' get next till no more

LaunchProcess as Process
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return nil.
Function: Returns the application which launched the current one.
Notes: For some applications like the "loginwindow" it's nil, because there was no app to launch it other than the system itself.

MacCreator as string
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return "".
Function: Returns the Mac Creator code for the application.

MacType as string
property, Process So, 26. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return "".
Function: Returns the Mac Type code for the application.
Notes:
Possible values:
"APPL"normal application
"appe"background application (Classic)
"APPC"Control panel application (Classic)
"APPD"Desktop Accessory (Classic)
"FNDR"Finder
others may be possible.

MemoryFree as integer
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return 0.
Function: Returns the size of the free space in the process' memory partition.
Notes: On Mac OS X normally 0.

MemorySize as integer
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return 0.
Function: Returns size of the process' memory partition.
Notes: On Mac OS X normally 0.

Path as folderitem
property, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does allways return 0.
Function: Returns the path of the process' file.
Notes:
Maybe nil if not available.
Use this folderitem to get an icon for the process.
(and this icon may be nil!)

ProcessID as integer
property, Process So, 28. Apr 2002
Mac OS Classic: does allways return 0. Mac OS Carbon: Works. Windows: does allways return 0.
Function: Returns the PID of the process for use in unix command line tools.
Notes:
Works only on Mac OS X.
See CPU Focus for example.

SameAs(other as process) as boolean
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Returns true if two process objects have the same process.

Update
method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Updates the classes information.
Notes: Use it if you want the current CPUTime value after some time.

Visible as boolean
property, Process Mi, 17. Jul 2002
Mac OS Classic: does allways return false. Mac OS Carbon: Works. Windows: does allways return false.
Function: Returns true if the application is visible.
Notes:
Works only on Mac OS X and CarbonLib 1.5 or later.
Returns false if not supported.

CountProcesses
global method, Process So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: does nothing.
Function: Counts how many processes are running.
Notes:
Short for this function:

function CountProcesses as integer
dim n as integer
dim p as process

p=new process
p.getfirstProcess
n=1
while p.getnextProcess
n=n+1
wend

return n
end if

Contact

Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.

This resource fork intentionally left blank ˇˇ